OPC Studio User's Guide and Reference
SubscribeTarget(UAClientMapper,Boolean,Object,Predicate<IEnumerable<String>>,Boolean) Method



OpcLabs.EasyOpcUA Assembly > OpcLabs.EasyOpc.UA.LiveMapping.Extensions Namespace > UAMapperExtension Class > SubscribeTarget Method : SubscribeTarget(UAClientMapper,Boolean,Object,Predicate<IEnumerable<String>>,Boolean) Method
The mapper object that will perform the operation.

The value of this parameter cannot be null (Nothing in Visual Basic).

true to subscribe; false to unsubscribe.
The object being targeted.

The value of this parameter cannot be null (Nothing in Visual Basic).

The operation will be performed only on mappings whose mapping tags satisfy this predicate.

The value of this parameter cannot be null (Nothing in Visual Basic).

true to operate on sub-targets (mapped members of the target) recursively; false otherwise.
Executes the "Subscribe" operation on members of given target object, specifying the mapping tags predicate, and recursion flag.
Syntax
'Declaration
 
<ExtensionAttribute()>
Public Overloads Shared Sub SubscribeTarget( _
   ByVal mapper As UAClientMapper, _
   ByVal active As Boolean, _
   ByVal targetObject As Object, _
   ByVal mappingTagsPredicate As Predicate(Of IEnumerable(Of String)), _
   ByVal recurse As Boolean _
) 
'Usage
 
Dim mapper As UAClientMapper
Dim active As Boolean
Dim targetObject As Object
Dim mappingTagsPredicate As Predicate(Of IEnumerable(Of String))
Dim recurse As Boolean
 
UAMapperExtension.SubscribeTarget(mapper, active, targetObject, mappingTagsPredicate, recurse)

Parameters

mapper
The mapper object that will perform the operation.

The value of this parameter cannot be null (Nothing in Visual Basic).

active
true to subscribe; false to unsubscribe.
targetObject
The object being targeted.

The value of this parameter cannot be null (Nothing in Visual Basic).

mappingTagsPredicate
The operation will be performed only on mappings whose mapping tags satisfy this predicate.

The value of this parameter cannot be null (Nothing in Visual Basic).

recurse
true to operate on sub-targets (mapped members of the target) recursively; false otherwise.
Exceptions
ExceptionDescription

A null reference (Nothing in Visual Basic) is passed to a method that does not accept it as a valid argument.

This is a usage error, i.e. it will never occur (the exception will not be thrown) in a correctly written program. Your code should not catch this exception.

The component is not licensed for the operation requested.
Remarks

This is an extension method (info: C#, VB.NET). In languages that have support for extensions methods (such as C# and VB.NET), you can use the extension method as if it were a regular method on the object that is its first parameter. In other languages (such as with Python.NET), you will call the extension as a static method, and pass it the object on which it acts as its first parameter.

Requirements

Target Platforms: .NET Framework: Windows 10 (selected versions), Windows 11 (selected versions), Windows Server 2016, Windows Server 2022; .NET: Linux, macOS, Microsoft Windows

See Also